home *** CD-ROM | disk | FTP | other *** search
/ PC World Interactive 7 / PC World Interactive 7.iso / pcgames / EMERGY / BC5 / EXAMPLES / OWL / APPS / BLAZER / readme.txt
Text File  |  1997-03-25  |  3KB  |  69 lines
  1. Copyright Borland International
  2. ObjectWindows (C) 1995, 1996
  3.  
  4. Title: BLAZER Example
  5.  
  6. Keywords: TSplashWindow;TMci;TMciWaveAudio;Directory listing;THarbor;
  7.           Dockable toolbars;TControlBar;TModeGadget;TTextGadget;TStatusBar;
  8.           TButtonGadget;TControlGadget;Common Controls;TPaneSplitter;
  9.           TListWindow;TTreeWindow;Context-sensitive Help;MAPI;TRecentFiles;
  10.           Context menu;TPropertySheet;TSlider
  11.  
  12.  
  13. The BLAZER sample application illustrates many of the common control
  14. encapsulations. It is designed to be run only in 32-bit flat model.
  15.  
  16.  
  17. When run, the application displays a TSplashWindow. If you have a sound
  18. system, you can also hear an engine roar in the background. That's the
  19. TMciWaveAudio encapsulation working. In the meantime, a directory listing
  20. is being retrieved from the C: drive.
  21.  
  22.  
  23. Once the application comes up, you'll notice the application has a menu.
  24. If you press the F1 key any time a menu choice is highlighted, the help
  25. page for that particular option is displayed. If any of the controls have
  26. focus and the F1 key is pressed, the help page for that control is
  27. displayed. This is the THelpFileManager class in action. Take a look at
  28. the header file to see how DECLARE_HELPCONTEXT() is used. Also, take a look
  29. at client.cpp to see how DEFINE_HELPCONTEXT is used. Notice in particular
  30. the macros HCENTRY_MENU and HCENTRY_CONTROL. With the help manager, it is
  31. required to use SETUP_HELPCONTEXT() and CLEANUP_HELPCONTEXT() to make sure
  32. the correct context table is used.
  33.  
  34.  
  35. The menu has two top-level choices: File and Help. The File menu has three
  36. choices: Select to MRU, Send, and Exit. The Select to MRU option selects a
  37. file to the Most Recently Used (MRU) list (TRecentFiles). The Send menu
  38. option is only active when a file is selected from the TListWindow (more
  39. on TListWindow later). The Send demonstrates the MAPI encapsulation.
  40.  
  41.  
  42. The Help top-level menu has only one choice: About. The About box here is
  43. not a dialog, but rather a layout window. The window contains a bouncing
  44. ball (TDiBitmap), and three buttons. If you click the right mouse button
  45. on the bouncing ball area, the context menu is displayed. The context menu
  46. displays the same menu choices as the three buttons: Ok, Help, and
  47. Options. The Ok button closes the about box. The Help button displays the
  48. help page for the about box. The Options displays a property sheet
  49. (TPropertySheet) for the various options of the bouncing ball.
  50.  
  51.  
  52. So much for the menu options. The main window is divided by a
  53. TPaneSplitter. On the left pane is the TTreeWindow and the right is a
  54. TListWindow. The TTreeWindow displays the directory hierarchy for the
  55. current drive. When a directory is selected with the mouse, the
  56. TListWindow is filled with the files in that directory. For more uses of
  57. the TListWindow, see the CLASSES/LISTWIND example.
  58.  
  59.  
  60. Above and below the two panes are dockable gadget windows. These dockable
  61. windows come up docked in the harbors. You can drag them out of the
  62. harbors to make them float. When the windows are floating, you can resize
  63. them to fit any rectangular area and the gadgets know how to resize
  64. themselves.
  65.  
  66.  
  67.  
  68.  
  69.